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The "BFBDEM" Diskette contains all of the major demonstration programE that are in the 
book, "BASIC Faster and Better £. Other Mysteries", by Lewis RosenfeLder. 

These programs demonstrate and test the programming techniques, subroutines and tricks 
described in the book. You will find that they will give you a good feel for the speed and 
power provided by the techniques. They will aLso heLp you test modifications that you may 
want to make. Many of the programs can even be expanded into complete applications by 
adding or modifying a few Lines. Or, you can deLete Lines and merge the Logic that you 
need into your application program. 

Testing programs and routines is one of the most time consuming tasks of programming. 
You've aleady saved yourself hours of work, because alL but the very short demonstration 
programs are included — no typing, proof reading or debugging is necessary 1 

A companion diskette, "BFBLIB" contains the programs and routines from the book, 
organized as a convenient "merge" library. With these programs and files you will have the 
major functions, subroutines, USR routines, and utility programs that will make your BASIC 
programs "faster and better". 

The book "BASIC Faster and Better & Other Mysteries" is your main documentation and 
instruction manual for the BFBDEM diskette. Before attempting to use any programs or 
routines, be sure to carefully read the sections of the book that pertain to the 
demonstration program you are using. 

There is a brief description of each demonstration program's function below and a 
reference to the page in "BASIC Faster and Better & Other Mysteries" where you will find 
detailed information about each program. 



WHAT TO DO FIRST 

1. If you have a TRS-BO Model I, your first step is to make a backup copy of the BFBDEM 
diskette, using the procedures explained in the "TRSDOS tk Disk BASIC Reference ManuaL", 
page 5-2. 

NOTE: If you are using another disk operating system you will have to refer to that 
system's manual on the backup procedure. 

2. If you have a TRS-BO Model III, you will need to use the CONVERT utiLity (see your Disk 
System Owner's manuaL, page 68), to transfer the diskette contents to double density ModeL 
III diskettes. Then you can make your backup copy. All the BFBDEM programs can be stored 
on a single ModeL III system diskette. 

NOTE: If you are using another disk operating system you wilL have to refer to that 
system's manuaL on the ModeL I - ModeL III conversion procedure. 

After you've made a backup copy, use it as your working copy - DO NOT use your original 
for day-to-day programming. You may want to make modifications and additions, so, be sure 
to keep your original unaltered copy for protection. As an added precaution, be sure that 
your original copy is "write protected" (ModeL I users see TRSDOS & Disk BASIC Reference 
ManuaL page 2-6; ModeL III users see Disk System Owner's manual page 5). Do not "write 
protect" your WORKING DISK. 
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THE BFBDEM DISKE TTE 

The BFBDB4 diskette contains the foLLowing 32 demonstration programs and SETUPDBVBAS, 
program that is not included in "BASIC Faster and Better & Other Mysteries". 



SEARCH1/DB-I 

BITMAPFN/DB1 

J0URNEY/DB1 

S0RT3/DEM 

ELBCUP/DB4 

M0VEX/DB4 

UPDOWi/DBI 

SETUPDBVBAS 

VET0M/DB1 

VDRIVE/BAS 

VARPASS/RCV 



VKANDLBVDB1 

VARPASa/DEW 

0VERLAY1/B0V 

0VERLAY2/B0V 

COMUNCOM/Dm 

HZIG/DB4 

OVB3LAY2/TOV 

OVERLAYB/DEM 

MASTER/BOV 

FREEFORM/DB4 

BITSRCH/DB-l 



S0RT2/DB-1 

0VERLAYT/DB1 

VDRIVE2/BAS 

FLASH/DB4 

SCR0LLUP/DB4 

DOSCHECK/BAS 

SUMSNG/DEM 

IDARRAY/DB1 

SUM3BL/DB1 

0VERLAY1/T0V 

KWKARRAY/DB4 



"SE7UPDBVBAS" is a special program that may be used to customize the programs on the 
BFBDB1 diskette that require changes to be compatible with the disk operating system you 
are using. 

The modifications made by "SETUPDB1/BAS" are not necessary if you are using TRSDOS 2.3, 
with three files, but no harm will be done by running it. If you purchase a different disk 
operating system, or if a new version of your current DOS is released, you may re-run 
"SETUPDBVBAS" to alter the affected BFBDBI files. 



USING "SETUPDBVBAS" 

To run "SETUPDB4/BAS", Load BASIC, specifying at least 1 file. 

Then type: RUN "SETUPDB1/BAS" 

The program will dispLay the program's "billboard" message until you press any key (except 
BREAK, of course). After you have pressed a key, the program will automatically find the 
correct addresses within the system you are using and then made the appropriate 
modifications to the BFBDEM demonstration programs. 

The "MOVEX" and "COMUNCOM" routines as used in the programs "M0VEX/DB4", "J0URNEY/DB1", 
and "COMUNCOM/DEM" are modified so that the USR routine address pointers will be correct. 
Refer to the sections in the book that expLain "MOVEX", "COMUNCOM", and the "MultipLe 
Argument Handler" for an explanation of these modifications. "MOVEX" is modified so that 
it will operate as USRO. "COMUNCOM" is modified so that it will operate as USR7. 

"SETDPDBVBAS" aLso modifies "0VERLAY1/T0V" and "0Vmi_AY2/T0V" . These are overlay programs 
that are loaded and run by the top-loaded overLey demonstration program, "0VERLAYT/DB4". 
The modification made is to change the POKE commands in line 30001 so that the beginning 
of text address, and number of files will be correct for the disk operating system that 
you are using. (It is possible that if you are using a disk operating system, or number of 
files setting, that creates a particularly high beginning of text address, you may need to 
make further modifications in order to run the "OVffiLAYT/DBT and "OVBtt-AYB/DBI" programs. 
See pages 67 and 71 for more detaiLsJ. 
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"SETUPDBVBAS" expects to find the required programs "on-line" end the dets to be modified 
at specific byte positions within those programs. It verifies that you have not added, 
deleted, or edited Lines preceding the points to be modified by checking a few bytes 
immediately preceding and following the deta to be modified. Because of this, "MOVEX/DB-I", 
"JOURNEY/DBl", "CX)MUNCOM/DEM", "0VffiLAY1/T0V" , and "0VERLAY2/T0V" shouLd be exact copies 
of those found on your original BFBDBi diskette, or the program will abort. You may modify 
your BFBDB-I disk as many times as you wish for as may diek operating systems as you have. 

NOTE: For proper modification of the "QVERLAYT/DB-1" programs, you must specify the number 
of files that you will be using when you test them, and if you will be using the video 
driver program "VDRIVE2/BAS", you should run it before "SETLPDB4/BAS". 



THE DEMONSTRA TION PROGRAMS 

These demonstration programs will help you to understand the various techniques and tricks 
that are described in "BASIC Faster and Better & Other Mysteries". You can analyze the 
code, "see" how each function, subroutine or technique works and modify the programs to 
test your own ideas and techniques. By using the TOON and TBOFF functions of your TRS-80, 
you can "trace" the logic of each demonstration program. You can even use portions of the 
"demonstration" in your own program! 

Following are brief descriptions of each program and the page number reference to the 
appropriate chapter in "BASIC Faster and Better & Other Mysteries" where you will find the 
complete documentation for each program. 

BUSRC H/Dffi - demonstrates the BITSRCH USR subroutine for searching bit-map strings. 

* For more details see page 123 

BITMAPFN/D B^l - demonstrates the bit-map string function calls. 

* For more details see page 120 

COMUNC OH/DEM - demonstrates the use of the COMUNCOM USR routine and the FNKM$ function to 
compress and uncompress strings. You will need to use SETUPDEM/BAS if your operating 
system is not TRSDOS 2.3. 

* For more details see page 95 

ELBCU P/DEM - is the array element duplication demonstration. 

* For more detaiLs see page 125 

FLASH/D EM - demonstrates the screen save and flashback subroutine. 

* For more details see page 194 
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FREEF0RH/DB4 ~ is the free-form video displey program. It demonstrates repeating key 
capabilities, a flashing cursor, insertions and deletions. 

* For more detai Ls see page 176 

HZI0/DEJ4 - demonstrates the horizontal input/output subroutine for data entry and 
qi splay. 

* For more detai Is see page 196 

IDAR RAY/DEM - is a demonstration of array element insertions and deletions with the 
IDARRAY USR subroutine. 

* For more details see page 127 

JOURNEY/DBt - scroLls the video display through 64K of memory, showing the current address 
at the bottom of the screen. 

* For more details see page 55 

KWKARRAY/DB1 - uses the video displey to demonstrate the commands of the KWKARRAY USR 
routine. 

* For more details see page 145 

M0VEX/DB4 - demonstrates the MDVEX USR subroutine. You wilL need to use SETUPDBVBAS if 
you are using a disk operating system other than "mSDOS 2.3. 

* For more detai Is see page 55 

QVffLAYB/DBI - is the bottom-loaded overlay demonstration. 

MASTER/BOV - is part of the bottom- leaded overlay demonstration. You should not run it 
directly. It is loaded by OVffiLAYB/DBl. 

O VERLAYV fity - is part of the bottom- Loaded over Lay demonstration. You should not run it 
directly. It is loaded by OVBIAYB/DBI. 

0VERLAY2/B0\/ - is part of the bottom-Loaded overLay demonstration. You should not run it 
directly. It is Loaded by OVERLAYB/DB<i. 

* For more details see page 71 

QVERLAYT/DB1 - is the top-loaded overLay demonstration. 

0VERLAY1/T0V - is part of the top-Loaded overLay demonstration. You should not run it 
directly. It is Loaded by OVB3LAYT/DB4. 

0VERLAY2/T0V - is part of the top-Loaded overLay demonstration. You should not run it 
directly. It is Loaded by OVERLAYT/DBi. 

* For more detai Ls see page 67 
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SCROL LUP/DBi - demonstrates split-screen scrolling using random data. 

* For more detai Is see page 2D0 

SEARCH1/DB4 - demonstrates the SEARCH1 LiSR subroutine for high-speed searches of string 
arrays. 

* For more detai Ls see page 131 

S0RT2/DE M - use6 the video dispLay to demonstrate the high-speed memory sort performed by 
the SORT2 USR subroutine. 

* For more details see page 152 

SQRT3/DB1 - uses the video dispLay to demonstrate the method of sorting by insertion used 
by the S0RT3 USR subroutine. 

* For more details see page 155 

SUNDBL/ DB4 - is a demonstration of the SUMDBL USR subroutine, which sums double precision 
arrays. 

* For more detai Is see page 82 

SUMSNG/DB1 - demonstrates the SUMSNG USR subroutine, which sums single precision arrays. 

* For more details see page 82 

VARPASS/D EM - shows how you can pass variables from one program to another. It creates 
some demonstration data and passes it to VARPASS/RCV. 

VARPASS/RCV is the receiving program in the variable passing demonstration. It is 
loaded and run by VARPASS/DB4. You should not run it directly. 

* For more detai Ls see page 58 

VET0M/DB1 - demonstrates the scroLLed video entry handler. If you wish to test the disk 
save and load capabilities you should specify at least 1 file upon loading BASIC and you 
shouLd have a formatted disk available with several grans of free space. Be aware that it 
automatically changes the memory size setting. After running the program you can restore 
the original memory size by re-booting or by poking the proper addresses. 

* For more details see page 211 

VHANDLER/DEM - is a demonstration of the unscroLLed video handLer. It also demonstrates 
all the inkey subroutines. You will need a disk that isn't write protected in drive zero. 

The program opens, but does not actually use,' a temporary file, "TEST", on drive zero. You 
will need to specify at least 1 file upon Loading BASIC. Also, if you've got a ModeL I 
TBSr-80 with an upper-lower case kit installed, be sure that you've loaded a video driver 
such as VDRIVE/BAS, VDRIVE2/BAS or Radio Shack's ULCDVR. 

* For more detai Ls see page 229 
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UPPQMI/DEM - demonstrates the up and down sc rolling subroutines to scroll data from an 
array onto the video display. 

* For more detai Is see page 302 

For your convenience, "VDRIVE/BAS", "VDRIVE2/BAS", and "DOSCHECK/RAS" are included on the 
BFBDEM diskette. Their purpose and operation are discussed in "BASIC Faster and Better". 
If you have had your Model I modified for upper and lower case operation, "VDRIVE/BAS" 
"VDRIVE2/BAS", or Radio Shack's ULCDVR will be necessary in those programs containing Line 
40070, the video dispLay string pointer subroutine. 



NOTE: DOSPLUS 3. 3D and some other operating systems have a comparatively high beginning of 
text address. To run the VARPAS&/DEM and OVERLAYT/DEM programs you should specify no more 
than 1 file upon entering BASIC and when running SETUPDEH/BAS . 

SETUPDEM/BAS does not modify OVERLAYB/DEM. To run it you wilL need to specify files 
upon start-up and manually make the modifications to OVERLAYB/DEM, MASTER/BOV 
0VERLAY1/B0V and OVERUYS/BOV as specified in Model 2 note 31, page 250. This applies to 
any disk operating system where the beginning of text address is above 27000 decimaL on 
ModeLs I and III. 



This documentation was prepared on a TRS-80 model I computer with 48K, 4 disk drives, NEC 
printer, NEWD0S/80 2.0 operating system and The ELECTRIC PENCIL 2.0z word processing 
system. 
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WARRANTIES 

UG r Inc. warrants that any software supplied on diskette or cassette tape i6 free from 
mechanical or recording defects and that UG f Inc. will replace any diskette or cassette 
tape with recording or mechanical defects within 10 days from the date of purchase. No 
other warranties are expressed or implied as to the operation, use or viabiLity of the 
programs. 

If the magnetic media, on which the program(s) are distributed is defective, return the 
original distribution copy within 10 days from purchase dete to: 

IJG, Inc. 

1260 West Foothill Blvd. 

Upland, California 91786 

Be sure to include proof of purchase and your return address. 



NOTICE OF DISCLAIMER 



IJG, Inc. and its authors shall have no liability or responsibility to the purchaser or 
any other person, persons or entity with respect to any LiabiLity, Loss or damage caused 
or alleged to be ceused directly or indirectly by computer equipment or the programs 
manufactured and distributed by IJG, operating on that equipment, including but not 
Limited to any interruption of service, loss of business or anticipated profits or 
consequential damages resulting from the use or operation of any computer with any 
programs manufactured or distributed by IJG, Inc. 



SOFTWARE UPGRADE POLICY 



It is assumed that each person using this release or previous releases of the purchased 
software he6 had the full use of the program(s) and therefore has received full and 
adequate compensation for the purchase price of the programls). IJG, Inc. does not intend 
or intend to imply that future releases of the software will be "upgraded" et e reduced 
price or offered to current owners of thi6 reLease or previous reLeases of the software, 
at a reduced price or trade-in allowance for future products bearing the same name. 



